home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / answers / news / inn-faq / part2 < prev    next >
Internet Message Format  |  1994-04-04  |  57KB

  1. Path: bloom-beacon.mit.edu!hookup!swrinde!cs.utexas.edu!uunet!news.mentorg.com!sdl!not-for-mail
  2. From: tal@Warren.MENTORG.COM (Tom Limoncelli)
  3. Newsgroups: news.software.nntp,news.software.b,news.answers
  4. Subject: INN FAQ Part 2/4: Debugging Guide & Tutorial
  5. Supersedes: <inn-faq-2-764139607@Warren.MENTORG.COM>
  6. Followup-To: news.software.nntp
  7. Date: 5 Apr 1994 04:00:12 -0000
  8. Organization: Mentor Graphics - IC Group, Warren, NJ, USA
  9. Lines: 1392
  10. Sender: tal@Warren.MENTORG.COM
  11. Approved: news-answers-request@MIT.Edu
  12. Distribution: world
  13. Expires: 04/20/94
  14. Message-ID: <inn-faq-2-765518407@Warren.MENTORG.COM>
  15. References: <inn-faq-1-765518407@Warren.MENTORG.COM>
  16. Reply-To: Tom_Limoncelli@Warren.MENTORG.COM (Tom Limoncelli)
  17. NNTP-Posting-Host: sdl.warren.mentorg.com
  18. X-Summary-1: Part 1: Common questions about INN itself, useful to people that do not currently run INN.  Also, some advice specific to certain operating systems.
  19. X-Summary-2: Part 2: Read this AFTER you've read and followed the directions in Install.ms.  Help with getting innd to start.  A tutorial on debugging posting/access problems.  A list of error messages and what they mean.
  20. X-Summary-3: Part 3: Day-to-day operational questions.  General questions asked once INN is running for a while.  Some big changes you can make.  Bug warnings for 1.4, 1.3, 1.2.
  21. X-Summary-4: Part 4: Norman's quick guide to getting started (assumes SunOS and other things), and misc. other things.
  22. Xref: bloom-beacon.mit.edu news.software.nntp:5479 news.software.b:4160 news.answers:17686
  23.  
  24. Posted-By: auto-faq 2.4
  25. Archive-name: inn-faq/part2
  26.  
  27. Last Changed: $Id: FAQ-inn.2,v 1.25 1994/03/31 21:21:56 tal Exp $
  28.  
  29.                   Part 2 of 4
  30.  
  31. INN FAQ Part 1/4: General Information
  32. INN FAQ Part 2/4: Debugging Guide & Tutorial
  33.                      Reasons why INN isn't starting
  34.                      The debugging tutorial
  35.                      Other error messages and what they mean
  36. INN FAQ Part 3/4: Operational and Misc. Questions
  37. INN FAQ Part 4/4: Appendix A: Norman's install guide
  38.  
  39.  
  40. ------------------------------
  41.  
  42. Subject:  Table Of Contents for Part 2/4
  43.  
  44. =====================================================================
  45.      TABLE OF CONTENTS FOR PART 2/4:  Debugging Guide & Tutorial
  46. =====================================================================
  47.  
  48. REASONS WHY INN ISN'T STARTING:
  49.     Why does innd just exit right away with no message?
  50.     syslog message: ME internal no to group
  51.     syslog message: ME internal no control and/or junk group
  52.     syslog message: Can't setup communication (bind failure)
  53.     syslog message: ME bad_newsfeeds no feeding sites
  54.     syslog message: ME cant GetConfigValue
  55. THE DEBUGGING TUTORIAL:
  56.     Should I read the Install.ms file in its entirety
  57.         before reading this document?
  58.     Terminology used in the rest of this document.
  59.     How does it all fit together?
  60.     What should I monitor as I debug INN problems?
  61.     My innd won't start!
  62.     Connecting to a TCP/IP server.
  63.     Make sure that "feeders" can connect.
  64.     Make sure that "readers" can connect.
  65.     Make sure that clients can post.
  66.     "client" doesn't have the software needed to post.
  67.     Introduction to the "newsfeeds" file
  68.     The ME line in the newsfeeds file.
  69.     How does the "ME" line interact with the other lines?
  70.     Cookbook example of an outgoing NNTP feed.
  71.     Cookbook example of an outgoing UUCP feed.
  72.     Cookbook example of an outgoing UUCP-over-TCP feed.
  73.     Testing an outgoing feed (your "newsfeeds" configuration).
  74.     Other cron jobs.
  75.     Cookbook example setting up NOV ("overchan").
  76.     How do I use nntplink with INN?
  77.     How do I use newsgate with INN?
  78. OTHER ERROR MESSAGES AND WHAT THEY MEAN:
  79.     ld.so: Undefined symbol: _dbzwritethrough
  80.     Why does my innd often die with the message "Can't sync history..."
  81.     syslog message: ME cant sendto CCreader bytes 4 No such file
  82.         or directory.
  83.     inews says "bad message-id"
  84.     Why do all these "readclose" messages show up in my syslog?
  85.     "File exists writing symlinking article file -- throttling"
  86.     "cant fopen <newsgroup>/.thread No such file or directory"
  87.     news.daily reports: "Expire had problems removing articles"
  88.     syslog: ME cant nonblock 15 Operation not supported.
  89.     innd: ME cant update_active control
  90.     syslog message: innxmit[1234]: max connect failed Error 0
  91.     Can't open "/usr/local/news/shlock955", Permission denied
  92.  
  93.  
  94. =====================================================================
  95.                    REASONS WHY INN ISN'T STARTING
  96. =====================================================================
  97.  
  98. ------------------------------
  99.  
  100. Subject:  Why does innd just exit right away with no message?
  101.  
  102. First, fix your syslog: innd always logs a message before it exits.  (The
  103. INN distribution includes a version of the current UCB syslog, along with
  104. instructions on how to install it.  Ultrix systems might want to look at
  105. the syslog that is available on gatekeeper.dec.com) Second, the most
  106. common cause of this is that you do not have a history file (or no history
  107. database).  You will see a message like this:
  108.     ME cant dbminit /usr/local/news/history No such file or directory
  109. This means that you do not have a history database.  You might want to run
  110. the BUILD script in your INN source tree or read about makehistory in
  111. doc/news-recovery.8; if you do the latter, make sure to rename the
  112. database files. 
  113. ******This FAQ covers general questions about INN and questions
  114. about how to compile it.  For information on configuration and debugging
  115. one's configuration, see the "INN Configuration FAQ".
  116.  
  117.  
  118. ------------------------------
  119.  
  120. Subject:  syslog message: ME internal no to group
  121.  
  122. Nelson Minar <nelson@reed.edu> discovered the hard way that:
  123.  
  124. If you set MERGE_TO_GROUPS to "DO",
  125.  
  126. You have to have a "to" group listed in your "active" file or you will
  127. get the above syslog message and innd will not start.
  128.  
  129.  
  130. ------------------------------
  131.  
  132. Subject:  syslog message: ME internal no control and/or junk group
  133.  
  134. You must have a newsgroup named "control" and a newsgroup named
  135. "junk" for innd to start.
  136.  
  137.  
  138. ------------------------------
  139.  
  140. Subject:  syslog message: Can't setup communication (bind failure)
  141.  
  142. The message "Can't setup communication (bind failure) Permission denied"
  143. means that the permissions on your _PATH_NEWSCONTROL directory
  144. are wrong.  You might want to delete the directory and "make install"
  145. to create it again.
  146.  
  147.  
  148. ------------------------------
  149.  
  150. Subject:  syslog message: ME bad_newsfeeds no feeding sites
  151.  
  152. (Rich Salz replies:) The syslog message is telling you that you are not
  153. feeding news to any sites.  You have to have at least one feed.  (You
  154. may consider this to be a bug, it's just that I'm too lazy to make
  155. everything work right if you don't have any newsfeeds.)
  156.  
  157. Until you go into production and start feeding sites, add a line like this:
  158.         dummy-feed:!*::
  159.  
  160.  
  161. ------------------------------
  162.  
  163. Subject:  syslog message: ME cant GetConfigValue
  164.  
  165. Jan 12 17:38:06 galaxy innd: ME cant GetConfigValue pathhost Error 0
  166.                                                     ^^^^^^^^
  167.  
  168. This means you don't have "pathhost:" in your inn.conf.
  169.  
  170. GetConfigValue is the routine that gets data out of the inn.conf file.
  171. If you get the above error, it means you don't have a particular value
  172. in your inn.conf.  Run "inncheck -v" usually will tell you what you
  173. need to do.
  174.  
  175.  
  176. =====================================================================
  177.                        THE DEBUGGING TUTORIAL
  178.                 (or, What do I do after Install.ms?)
  179. =====================================================================
  180.  
  181.  
  182. ------------------------------
  183.  
  184. Subject:  Should I read the Install.ms file in its entirety before reading this document?
  185.  
  186. YES!  Install.ms tells you how to compile and install the software.
  187. This document walks you through debugging the *configuration* of the
  188. software once it is installed.
  189.  
  190. This document takes you from where install.ms leaves off, gives you a
  191. quick overview of how all the pieces fit together, and then takes you
  192. through specific debugging tasks.
  193.  
  194. Debugging INN problems is often difficult because one needs to be an
  195. experienced netnews person to do it well.  You can only get experience
  196. by having a properly running system.  This is a catch-22.  This
  197. tutorial attempts to take you through the basics.  The rest you'll
  198. figure out.
  199.  
  200. Newsgroups you should know exist:
  201. news.software.nntp  -- INN questions go here.
  202. news.software.b     -- Discussions about any of the many software
  203.     packages that support the "B news" format (i.e. INN, C news,
  204.     ANU-NEWS, etc.)
  205.  
  206. This document also takes you through the process of verifying that your
  207. system is properly configured.  When you are done, you should:
  208.  
  209. 1.  be sure that when feeders connect they are treated as feeders.
  210.  
  211. 2.  be sure that when clients connect they are treated as clients.
  212.  
  213. 3.  be sure that posting works.
  214.  
  215. 4.  be sure that your out-bound feeds are properly configured.
  216.  
  217.  
  218. ------------------------------
  219.  
  220. Subject:  Terminology used in the rest of this document.
  221.  
  222. We will pretend that your machine is named "nntphost" or
  223. "nntphost.do.main" and that there is a client named "client" or
  224. "client.do.main".
  225.  
  226. Some machines connect to you to try to feed you new articles.  We'll
  227. call these machines "feeders".  Some machines try to connect to you to
  228. read and/or post articles.  We'll call these machines "readers".
  229.  
  230.  
  231. ------------------------------
  232.  
  233. Subject:  How does it all fit together?
  234.  
  235. Here is a fantastic overview of the workings of INN.
  236.  
  237. From: Ken Hornstein <kenh@leps5.phys.psu.edu>
  238.  
  239. I discovered that the biggest problem I had with INN was understanding how
  240. everything fits together (since I had no experience with B or C news).
  241. Here's a (hopefully) simple description of how everything fits
  242. together:
  243.  
  244. After running rc.news (as "root"), you should have the "innd" daemon
  245. running ("ps" will show the process to be owned by "news").  This is
  246. the Master Daemon.  It handles incoming connections, stores the
  247. articles on your disk, but does _not_ send any articles out itself.  It
  248. directs other programs to do that.  Exactly where articles are sent and
  249. how they are sent is determined by the "newsfeeds" file.  Setting up
  250. your newsfeeds file will be the hardest part of configuring INN.  Here
  251. are some example entries from my newsfeeds file:
  252.  
  253. ra/ra.nrl.navy.mil\
  254.         :*,!psu.*/!psu\
  255.         :Tf,Wnm:
  256.  
  257. Looks complicated?  It isn't.  Here's what it means:
  258.  
  259. "ra" is the name of the feed.  "/ra.nrl.navy.mil" is an alias for ra.
  260. This is important because INN uses the "Path" header to insure the
  261. articles are not sent to sites where they have already been.  Thus, any
  262. article that has "ra" or "ra.nrl.navy.mil" in the Path header will NOT
  263. be sent to this site.  We know that no other site inserts "ra.nrl.navy.mil"
  264. because it is a FQDN (Fully Qualified Domain Name).  We know that no
  265. other site inserts "ra" because it is registered in the UUCP Maps.
  266. (Ok, "ra" isn't registered so I'm just taking a small gamble.)
  267.  
  268. The second line tells what articles will be sent out to this site.
  269. "*,!psu.*" means that articles for (all newsgroups minus those that
  270. match "psu.*") will be sent to ra.  The details of the pattern matching
  271. is found in the wildmat(3) man page.  The "/!psu" means that articles
  272. with a "Distribution" header of psu will also not be sent to ra.
  273.  
  274. The last field specifies exactly what _kind_ of feeds.  "Tf" means this
  275. is a file feed.  Unless you have unusual requirements, all of your
  276. feeds will be file feeds.  "Wnm" means that the relative path name and
  277. the Message-ID of the article will be written to this file.  By
  278. default, this file is called the same name as your feed file, and is in
  279. your out.going directory.  So on my system, every article destined to
  280. ra will have its filename and Message-ID written to the file
  281. "/var/spool/news/out.going/ra".
  282.  
  283. So how do the articles actually GET to ra?  You run a program that
  284. reads the feeds file and transmits the article.  Two such programs are
  285. included with INN -- "send-nntp" and "nntpsend".  My personal
  286. preference is for nntpsend.  If you are going to use nntpsend, you will
  287. need to add a similar line to your nntpsend.ctl file:
  288.  
  289. ra:ra.nrl.navy.mil
  290.  
  291. This tells nntpsend that articles in the feed file "ra" should be sent
  292. to the site "ra.nrl.navy.mil".  I run nntpsend out of cron every 10
  293. minutes with this line (in /usr/lib/crontab):
  294.  
  295. 0,10,20,30,40,50 * * * * /bin/su news -c '/usr/local/news/bin/nntpsend'
  296.  
  297. This is under Ultrix.  A sane cron would let you specify the userid to
  298. run programs under.
  299.  
  300. UUCP feeds work similarly and are described in a different section.
  301.  
  302. As each article comes in (note that hosts feeding you _must_ be listed
  303. in the hosts.nntp file), innd will examine it and distribute to your
  304. listed feeds based on the above-described selection criteria.
  305.  
  306. Another important thing to do is to make sure your articles get
  307. expired.  This is done from the "news.daily" script.  The "expire.ctl"
  308. file describes how long you want each article to last.  Here are some
  309. sample lines from my expire.ctl:
  310.  
  311. /remember/:14
  312.  
  313. This line tells expire to keep history entries for articles 14 days
  314. after they have been deleted.
  315.  
  316. *:A:1:7:21
  317.  
  318. This is the default line.  This says that by default, an article is
  319. kept a minimum of one day, the default expiration time is 7 days (this
  320. applies if there is no "Expires" header), and the very maximum that the
  321. article is kept is 21 days.
  322.  
  323. psu.*:A:1:14:28
  324.  
  325. This line applies to groups only in Penn State.  By default, those
  326. articles will last 14 days, 28 days at the most.
  327.  
  328. Note that lines in expire.ctl should have the most general entries
  329. first, with the most specific entries last.
  330.  
  331. Lastly, where do newsreaders fit in?  When a newsreader connects to the
  332. innd process, it sees that this is not a feeder (the hosts.nntp file
  333. lists only sitest that feed YOU) so it forks a nnrpd process and hands
  334. the connection to it.  This way innd can concentrate on newsfeeds.
  335. Some newsreaders don't open a connection, but instead read the articles
  336. out of "/usr/spool/news" (and gets meta data from "/usr/lib/news").
  337. INN doesn't need to do anything about those readers except to make
  338. sure the right data is where they expect it.
  339.  
  340.  
  341. ------------------------------
  342.  
  343. Subject:  What should I monitor as I debug INN problems?
  344.  
  345. 1.  run "tail -f /var/adm/messages" to see if any syslog messages are
  346. being generated.
  347.  
  348. 2.  run "tail -f /var/log/news/news.err" to see if any fatal errors
  349. happen. 
  350.  
  351. 3.  Check for incoming email constantly (especially when trying to post
  352. from "nn").
  353.  
  354.  
  355. ------------------------------
  356.  
  357. Subject:  My innd won't start!
  358.  
  359. Keep a "tail -f /var/adm/messages" running.  INN reports most errors
  360. via syslog.  The syslog messages usually explain what is wrong.
  361. Elsewhere in this document are details about some of the less obvious
  362. syslog messages.
  363.  
  364. Chances are, INN is starting, finding a misconfigured "ME" line in the
  365. newsfeeds file, and exiting.  You might want to read the section on
  366. configuring your "newsfeeds" file first.
  367.  
  368. Rich Salz says a common reason is that you ran makehistory but didn't
  369. rename the DBZ files.  "makehistory" generates history.n.dir
  370. and history.n.pag.  They must be renamed:
  371.     mv history.n.dir history.dir
  372.     mv history.n.pag history.pag
  373.  
  374. Izar Tarandach <izar@cs.huji.ac.il> suggests that another common
  375. mistake is that innd wasn't being started by the correct uid.  innd
  376. (and therefore rc.news) must be started from "root" (not "news").  It
  377. immediately turns itself in user "news" once certain tasks are
  378. completed.
  379.  
  380. If you use a suid root inndstart, you can run it as any user.
  381.  
  382.  
  383. ------------------------------
  384.  
  385. Subject:  Connecting to a TCP/IP server.
  386.  
  387. You know that "telnet"'ing to a machine lets you log into it.  You are
  388. actually connecting on the "telnet" port (port 23).  Many TCP/IP
  389. services allow you to "telnet" into their port and talk directly to
  390. them.  Try "telnet nntphost 21".  This means log into port #21 (the
  391. "ftp" port) instead of the usual remote login port.
  392.  
  393. Once you are in, you'll get no prompt.  Type "help" and press RETURN.
  394. You should get a list of commands.  If you know what the commands are,
  395. you can talk to this server.  Type "quit" and press RETURN to get out.
  396.  
  397. After every command you should get some kind of status message.  Each
  398. line will begin with a number.  Each message has a unique number.
  399. Errors are defined as anything that starts with a number >= 400.
  400. Positive (non-error) messages are <400.
  401.  
  402. SMTP (mail) and NNTP (netnews) work the same way.  Telnet into their
  403. port and issue commands and data.  "quit" always gets you out.
  404.  
  405. We'll use this to debug INN configurations by "telnet"'ing into the
  406. innd server and seeing the raw error messages it gives us.
  407.  
  408. Try "telnet"'ing into the NNTP port (#119) of a working NNTP server to
  409. see what it's like.
  410.  
  411.  
  412. ------------------------------
  413.  
  414. Subject:  Make sure that "feeders" can connect.
  415.  
  416. "feeders" are listed in hosts.nntp.  "readers" are listed in
  417. nnrp.access.  This section deals with "feeders" and hosts.nntp.
  418.  
  419. When a machine connects to the NNTP port of nntphost, it connects to
  420. the innd process.  innd knows the internet address of the machine that
  421. is making this connection, and sees if it matches the internet
  422. addresses many of the machines listed in the hosts.nntp file.
  423.  
  424. If the machine is not listed in hosts.nntp, it is assumed that this
  425. machine is not a "feeder" and forks off a nnrpd to handle this
  426. connection as a "reader".  If you didn't know that, you didn't read
  427. enough of the INN installation documentation.  Go back and read it
  428. now.
  429.  
  430. Read the man page hosts.nntp to get a complete understanding of what's
  431. going on.  nnrpd uses its own authentication scheme, which is
  432. described in the next section.
  433.  
  434. Since I know you didn't read that man page, I'll give you one more
  435. chance to read it now.
  436.  
  437. Let's configure hosts.nntp.  Just enter the names of all the machines
  438. that feed you:
  439.  
  440. feeder1.do.main:
  441. feeder2.do.main:
  442.  
  443. I don't use passwords yet.  If you do, add them after the ":".
  444.  
  445. Now let's test to see if the feeder can connect properly.
  446.  
  447. Log into to the feeder and "telnet nntphost 119".
  448.  
  449. If you can't log into a feeder, configure your own machine as a feeder
  450. (i.e. feeder to itself) for testing purposes.  Once you can see that
  451. INN is treating that machine as a feeder you can replace the machine's
  452. name with the name of a real feed.
  453.  
  454. If you are given an error message and booted out, check the error
  455. message to see what's wrong.  Maybe the machine is running maintenance
  456. at the time and you have to try again later.  Maybe the machine doesn't
  457. recognize you at all and you have to edit "hosts.nntp" (and don't
  458. forget the "ctlinnd reload hosts.nntp" command!).
  459.  
  460. Run "inncheck" to tell you if you have made any obvious mistakes.
  461.  
  462. If your "history" file or other files have the wrong ownership or
  463. protections INN will mention the offending file in the error message.
  464. Another common mistake is that people try to use wildcards in
  465. hosts.nntp (which is not supported).  Remember, there are very few
  466. machines that you consider to be "feeders", so you don't want to use a
  467. wildcard.
  468.  
  469. To test a "feeder":  If "feeder1" can send an "ihave" command and get a
  470. "335" as a response, you know that "nntphost" is permitting "feeder1"
  471. to transfer news as a "feeder".  "ihave" requires an operand.  I
  472. usually type "ihave <1@test>" and press RETURN.  "<1@test>" is a
  473. Message-ID that I know doesn't exist.  If I get "500 What?" I know that
  474. innd assumed that I'm a "reader" (so I have to edit my "hosts.nntp"
  475. file and add this client).  If I get "335" and then a blank prompt,
  476. then INN is expecting to be fed an article.  I usually just "^]"
  477. (control-]) and "quit" out; I know that it was willing to accept the
  478. article.  If I get some other error message, it usually gives me enough
  479. information to debug the problem.
  480.  
  481.  
  482. ------------------------------
  483.  
  484. Subject:  Make sure that "readers" can connect.
  485.  
  486. As I wrote before, if a connection comes from a machine that isn't
  487. listed in the hosts.nntp file, it is assumed to be a "reader".  A
  488. "feeder" can also issue the "mode reader" command to become a
  489. "reader".  If you have "telnet"'ed in as a "feeder", try issuing this
  490. command.
  491.  
  492. Note: If a site is going to feed *and* read, you'll have to link
  493. readers with innd's client library. The reason for this is that the
  494. clients must tell innd that they want to read using the "mode reader"
  495. command.  The library does that automagically.  It is rare that you
  496. have a machine that is a reader and a feeder (since people will want to
  497. read on their local machine, not yours.)  News readers are now
  498. being packaged as "INN ready" so this will be less and less of a
  499. problem.
  500.  
  501. Once the connection has been handed off to nnrpd, nnrpd checks to make
  502. sure you are authorized.  It does that by reading the nnrp.access
  503. file.
  504.  
  505. There is a problem with what you enter in that file.  Namely, I might
  506. call the client machine "client", but that doesn't matter.  What
  507. matters is what "nntphost" thinks "client" is called.  Maybe "nntphost"
  508. thinks its name is "client.do.main" or even "137.202.177.3".  It
  509. doesn't matter what *you* call "client", permissions in the nnrp.access
  510. file have to be specified based on what "nntphost" calls "client".
  511. Technically, nntpd uses gethostbyaddr() to reverse-lookup the name.
  512. gethostbyaddr() uses DNS or, if you are on a brain-dead Sun running
  513. Sun's NIS/DNS hack, it uses NIS, or DNS, or whatever the hell Sun was
  514. thinking when they created that cruft.
  515.  
  516. To find out what "nntphost" thinks your machine is called, do the
  517. following:  Telnet from "client" to "nntphost" and execute the "finger"
  518. command (just "finger" alone on the command line).  The last column is
  519. what "nntphost" thinks your machine is called.
  520.  
  521. If you don't have an account on both machines things are more
  522. difficult, consult your NIS or DNS expert to tell you what the answer
  523. would be.
  524.  
  525. There is one exception to this technique.  If you are using SunOS and
  526. braindead NIS you get just the machine name (like "milk") instead of
  527. the FQDN (like "milk.warren.mentorg.com") then you must tack on a
  528. period then the domain of the machine.
  529.  
  530. So, with this knowledge (what your nntphost think's client's name is)
  531. and a copy of the man page, edit nnrp.access and add "nntphost"'s name
  532. for "client" to the file.  Unlike hosts.nntp, nnrp.access can have
  533. wildcards (for example, "*.sjc.mentorg.com").  You'll want to include
  534. wildcards for all the domains that should be allowed to read/post.
  535.  
  536. Here are some decent examples from my nnrp.access file:
  537.  
  538. -------------------------------------- Tom's nnrp.access file START
  539. ## Default is no access, no way to authentication, and no groups.
  540. *:: -no- : -no- :!*
  541. *.mentorg.com:Read:::*
  542. *.mentor.com:Read:::*
  543. *.warren.mentorg.com:Read Post:::*
  544. -------------------------------------- Tom's nnrp.access file END
  545.  
  546. The second field of "nnrp.access" is case sensitive.  "read post" does
  547. not mean the same as "Read Post".  If you know this already it's
  548. because you read the man page.
  549.  
  550. Note:  nnrpd will append the domain to a name that is not a FQDN.
  551. There is no need to try to find a wildcard that will match non-FQDN
  552. names (i.e. machines in your local NIS cluster).  Previously this FAQ
  553. had reported that "*[^.]*" would match these short names but that was
  554. wrong (the wildcard matches everything, oi!).  nnrpd turns non-FQDN's
  555. into FQDNs.
  556.  
  557. After you change "nnrp.access" you don't have do "ctlinnd reload" since
  558. the file is read by each nnrpd as they start up.
  559.  
  560. Now "nntphost" should be letting "client" read.  Let's test this out:
  561.  
  562. Log into to the reader and "telnet nntphost 119".
  563.  
  564. To test a "reader":  Give the "mode reader" command and see how it
  565. it goes.  If it doesn't give an error, then nnrp.access is letting you
  566. through.  To read an article (or just get the header) type "head
  567. <2@test>" and press RETURN.  Again, "<2@test>" is a message-id that I
  568. know doesn't exist.  If you are allowed to read at all, it will tell
  569. you that it can't find that article.  You should try the command with an
  570. message-id that you know exists and make sure you see the article's
  571. header.
  572.  
  573. If reading works you can skip to the next section.  The rest of this
  574. section helps you debug reading problems.
  575.  
  576. If "mode reader" gives an error (and rudely disconnects you) then you
  577. have a typo in nnrp.access OR you didn't issue the "ctlinnd reload"
  578. command correctly (or at all) OR nntphost thinks that "client" is
  579. called yet something else OR innd can't exec nnrpd for one reason or
  580. another -- see the syslog output or the innd.err log file.  Check all
  581. of those things then go to the beginning of this section and start
  582. over.
  583.  
  584. Note: Some telnet implementations are Real Stupid and disconnect you
  585. before showing the error message.
  586.  
  587. You can also run nnrpd by hand if you have
  588.     stdin:Read Post:::*
  589. in your nnrp.access file.  Just run nnrpd and type interactively.  This
  590. is useful for making sure it's compiled right.
  591.  
  592.  
  593. ------------------------------
  594.  
  595. Subject:  Make sure that clients can post.
  596.  
  597. The "inews" command (usually in /usr/local/bin) takes a post from a
  598. user, adds any missing headers, appends the first 4 lines of
  599. ~/.signature (if it exists), and possibly replaces any headers that are
  600. obviously forged.  "inews" will also reject a message if the message is
  601. seriously botched.  "inews -h" expects a post on stdin beginning with
  602. headers, then a blank line, then the body.  "inews -h -D" doesn't post
  603. the message, but outputs what it would have posted.  The minimum
  604. headers one can feed is "Newsgroups:" (which is plural) and "Subject:"
  605. (which is singular).
  606.  
  607. By the way, a header looks like "Header-Name: data".  I'm trying to
  608. point out after the header name there is exactly one colon then exactly
  609. one space.  The space is a space, not a tab.  Also, the list of
  610. newsgroups on the "Newsgroups:" line is a comma separated list, with no
  611. spaces.  There are no spaces before the colon.  If there is nothing
  612. after the colon or if there is only whitespace after the colon then
  613. that header will be removed by "inews".  Sites that don't remove such
  614. "empty" headers have broken software.  Get it?  Got it?  Good.
  615.  
  616. Here's the test message I constantly use:
  617. ------------------------ cut here 8<
  618. inews -h -D
  619. Newsgroups: foo.test
  620. Subject: test of inn posting
  621.  
  622. this is a test
  623. ------------------------ cut here 8<
  624.  
  625. Exciting huh?
  626.  
  627. You might also use the 'feedone' program in the frontends directory.
  628. Do "cd $inn/frontends ; make feedone" to get it built.  To run it, do
  629.  
  630.         feedone -t -r /tmp/inews.input
  631.  
  632. This will (-t) trace all I/O with the server and (-r) use a random
  633. message-id each time.  If you want to test posting from a newsreading
  634. host (i.e., one that connects to nnrpd and uses the POST command) use
  635. the -p flag.
  636.  
  637. If inews was able to get to the /usr/lib/news/inn.conf file (for
  638. defaults) you should get a nice post on your screen.  If you don't,
  639. here are my suggestions:
  640.  
  641. 1 -- You have an old inews from C news or B news laying around
  642. 2 -- inews will give you an error message saying what's wrong.
  643.  
  644. You might want to look around the usual places to make sure that there
  645. are no old versions of "relaynews" or "inews".  People trying to use
  646. the "inews" from C news will get a message about "can't open
  647. redirection" or similar.  Make sure they are running the programs
  648. included with INN.  There is something called "mini-inews" which should
  649. just take a post and send it to the nntp server.  Delete that and
  650. replace it with INN's inews.  INN's inews is mini-inews and regular
  651. inews, it is the ying and then yang of inewses.  It is the one true
  652. inews.  It is the one inews to end all inewses and all others are false
  653. idols.
  654.  
  655. Note:  False idol worshipper and heathen David Myers <dem@meaddata.com>
  656. reports that mini-inews works fine.  He stays with mini-inews...
  657. "because INN inews needs to access not only inn.conf, but moderators,
  658. too.  Installing and maintaining these files in a ~1000 client,
  659. multiple administrative domain setup like ours is too much of a pain.
  660. Most (all?) of the work done by INN inews is done by in.nnrpd during
  661. posting, anyway."
  662.  
  663. Kenji Rikitake <kenji@rcac.astem.or.jp> reports:
  664. "Keep in mind that INN inews refers to many environment variables.
  665. Beware of _inherited_ variables especially when you do su to maintain
  666. your news server.
  667. I got trapped and wasted a day with NNTPSERVER.  I tried to post to a
  668. local newsgroup, and inews kept refusing it and sending me 'no such
  669. newsgroups...' error message.  I finally found out that inews was
  670. looking up a wrong server, _implicitly_ specified by
  671. 'setenv NNTPSERVER ...' in my .login script.  It took a day to find
  672. such a subtle misconfiguration, after a whole recompilation of entire
  673. INN kit, active and history rebuilding, and all possible configuration
  674. checking.  *sigh*"
  675.  
  676. INN's inews sometimes prints the error: "Can't get list of newsgroups,
  677. No such file or directory.".  inews called CAlistactive() to get a
  678. local copy of the active file.  If it can't reach the active file you
  679. get this error.  Look at your PATH_TEMPACTIVE and see if it makes
  680. sense; i.e., if it is a valid /tmp directory.
  681.  
  682. "inews -h" sometimes reports:
  683.     Can't send article to the server:
  684.     441 480 Transfer permission denied
  685. This means that you set HAVE_UNIX_DOMAIN to DONT and you don't have
  686. your news server in its own hosts.nntp file.  (nnrpd gets a POST,
  687. connects to innd over a TCP socket and sends an IHAVE.) (thanks to Chris
  688. Jackson <cjj@sun.com> for pointing this out).  Add your news server's
  689. name to hosts.nntp and do "ctlinnd reload hosts.nntp".
  690. (for the reason why, read "Warnings to people that must set
  691. HAVE_UNIX_DOMAIN to DONT")
  692.  
  693. If it still doesn't work, look through your syslog to see the name
  694. of the host that innd got, and why it handed off to nnrpd.  Perhaps
  695. there is a DNS/NIS/hosts-file mismatch.  (suggested by Rich Salz)
  696.  
  697. Other problems are usually the result of not being able to find the
  698. "inn.conf" file (copy it to the client or make it available via NFS) or
  699. you are using Sun's brain-dead NIS/DNS stuff which doesn't do reverse
  700. name lookups well.  If inews tells you that it can't generate a
  701. Message-ID, this is because it can't figure out your domain (which is
  702. used in making the message-id string).  Force it to know your domain by
  703. adding a "domain:" line in "inn.conf".  Solaris 2.x users will get a
  704. "can't generate message-id" error if they didn't follow the advice
  705. about getfqdn.c mentioned in another part of this FAQ.
  706.  
  707. Once you get "inews -h -D" working, do the same test without the "-D" option
  708. and let it actually post the message.  If it can't post, it will tell
  709. you why.  If the answer isn't clear enough, "telnet nntphost 119", give
  710. the "mode reader" command, then the "post" command.  Enter lines of
  711. text like you would to "inews -h" and then type "." on a line by itself
  712. (and press RETURN).
  713.  
  714. If posting via "telnet nntphost 119" DOES work and posting via "inews -h"
  715. DOES NOT work, you know that (1) "inews" is compiled wrong, or more likely,
  716. (2) you aren't using INN's inews.  Either way, if this is happening
  717. you know you have narrowed your problems down to the inews program.
  718.  
  719. By the way, posting to misc.test is pretty useless considering that the
  720. entire world doesn't need to see your message.  Post to a local
  721. newsgroup or even a state-wide newsgroup like "nj.test" (assuming you
  722. are in New Jersey).  There are lots of people that reply to every test
  723. message they see, so expect to get tons of stupid email.  (though, if
  724. you don't get any email consider yourself lucky).  Also, there is no
  725. newsgroup called "news.test" so don't post there.  Many do, many fail.
  726. By the way, if you are one of those people that reply to every test
  727. message they see, get a real hobby.
  728.  
  729. Do *NOT* post your test message to a non-test newsgroup.  You will get
  730. many angry replies from all over the world.
  731.  
  732. Look at the posted message in the news spool (if you post a message to
  733. nj.test, "cd /var/spool/news/nj/test" and cat the highest numbered file
  734. you see).  If your site name is listed multiple times in the "Path:"
  735. header, put your server's name on the "pathhost:" line of "inn.conf"
  736. and recompile INN with "INEWS_PATH" set to "DONT".  (I don't know why
  737. Rich likes that as the default!)
  738.  
  739. REMEMBER:  inn.conf is read into innd only once.  After it is changed,
  740. the innd daemon must be shutdown and restarted.  (use "ctlinnd shutdown x"
  741. and then run rc.news as root).
  742.  
  743. If "inews -h" posts a message, smile because most of the battle is over.
  744.  
  745.  
  746. ------------------------------
  747.  
  748. Subject:  "client" doesn't have the software needed to post.
  749.  
  750. If the client doesn't have "inews" at all, copy it from the server (if
  751. they are compatible machines) or check the INN installation manual to
  752. find out how to compile just the client programs for a machine.  There
  753. is a special gimick included with INN to compile inews for the various
  754. other OS's and versions of Unix without having to compile the entire
  755. INN package.
  756.  
  757. Since nnpost, Pnews, postnews, and all other news posting software
  758. shouldn't do anything but ask for header information, let you add a
  759. body, and then pipe the whole thing to "inews -h", you can be pretty
  760. certain that if "inews -h" works, your news posting programs will
  761. work.  Think again!  Post from each of them and make sure they all get
  762. posted.  You might find that they access a copy of "inews" that was
  763. part of C news, mini-inews, or heavens knows what.
  764.  
  765. I highly recommend that people use "find" or "gnufind" to seek out and
  766. replace all old versions of "inews" with symbolic links to the one
  767. "official".
  768.  
  769. Something like:
  770.  
  771. gnufind / /usr /usr/local /usr/lib -xdev -follow -name inews\* -print
  772.  
  773. Then, for every file found, do the following:
  774.  
  775. mv inews inews.cnews
  776. ln -s /usr/local/bin/inews inews
  777.  
  778. Now you only have to update /usr/local/bin/inews, rather than
  779. chasing may copies.
  780.  
  781. "nn" and "nnpost" create a file called "~/.nn/params" right before you
  782. post with tons of useful information.  While posting you can shell out
  783. of the editor and view the file.  The file is deleted after the message
  784. is posted.  I had to view this file while shelled out of my editor to
  785. find which "inews" was being used by "nnpost".
  786.  
  787. It's also a good idea to check your mail now and then while you are
  788. doing this.  Some newsreaders (like "nn" notify you of a posting
  789. problem via mail.
  790.  
  791. On non-INN systems, "inews" returns pretty quickly.  Actually they fork
  792. a process to do the actual posting in the background.  When those
  793. "inews" return, you don't know if the post was successful or not.
  794. These "inews"'s have a "-W" option which turns off this forking feature
  795. (i.e. Wait for the post to complete).
  796.  
  797. INN's "inews" never forks because the wait is never that long.  When
  798. "inews" returns you know if the post was successful or not.  INN's
  799. "inews" accepts the "-W" option for compatibility.
  800.  
  801. This may seem obvious, but when posting a test message, consider
  802. including the machine you are posting from and the program you are
  803. using.  Even though you may check to see if the message got posted
  804. after every test, this will help you later when you go back to see what
  805. you have done.
  806.  
  807.  
  808. ------------------------------
  809.  
  810. Subject:  Introduction to the "newsfeeds" file
  811.  
  812. Outgoing news is controlled by the "newsfeeds" file.  The INN 1.2 man
  813. page for this file is a bit complex.  The man page in 1.3 (and beyond)
  814. gives better examples.  Here's a "cookbook" of examples that should
  815. cover most of your needs.  Debugging tips are also included.
  816.  
  817. Always remember that newsfeeds uses "wildmat" matches, not the
  818. semi-regular expressions that C news uses.  This means that if you want
  819. to get comp.foo and the subgroups under it (comp.foo.bar, comp.foo.baz,
  820. etc.) you have to use a statement like:
  821.  
  822. comp.foo,comp.foo.*
  823.  
  824. OR
  825.  
  826. comp.foo*
  827.  
  828. BUT NOT
  829.  
  830. comp.foo.*
  831.  
  832. However, "comp.foo*" will match "comp.foobar", as well as
  833. "comp.foo.bang".
  834.  
  835.  
  836. ------------------------------
  837.  
  838. Subject:  The ME line in the newsfeeds file.
  839.  
  840. The "ME" entry is a bit confusing.  Be careful when you
  841. read the man page.
  842.  
  843. Here is the "ME" line that I use in my "newsfeeds" file.  I find
  844. it works quite well, but you might want to remove the distributions
  845. that you don't need (i.e. New Jersey).  Since my site has clients
  846. reading from all over the world I try to have every distribution I
  847. can find.  However, I hear of a new distribution almost daily so this
  848. list is always changing.
  849.  
  850. ME:!*/\
  851. news,gnu,comp,biz,alt,rec,misc,sci,soc,talk,inet,world,worldwide,all,\
  852. aus,su,uk,york,eunet,na,can,qc,tor,us,usa,mn,oh,chi,ca,ba,tx,pnw,il,ne,\
  853. ny,nyc,phl,bl,nj,warren::
  854.  
  855. If you want to blindly accept all distributions, try this:
  856.  
  857. ME:!*::
  858.  
  859.  
  860. ------------------------------
  861.  
  862. Subject:  How does the "ME" line interact with the other lines?
  863.  
  864. > I'm still a little confused about the ME line's second field.
  865.  
  866. The man page as of INN 1.3 is much more clear on this.  Basically, the
  867. second field of the "ME" line specifies the default for the rest of the
  868. feeds.  Otherwise, it isn't used.  The "active" file declares which
  869. newsgroups you accept and don't accept.
  870.  
  871. Here are some examples:
  872.  
  873. ME:!*:::
  874. foo:!junk:...        --send no newsgroups
  875.  
  876. ME:*:::
  877. foo:!junk:...        --send all newsgroups except junk
  878.  
  879. ME:!*:::
  880. foo:*,!junk:...      --send all newsgroups except junk
  881.  
  882. By the way, generally you do not want to send "junk" or "control*" to
  883. your neighbors.
  884.  
  885.  
  886. ------------------------------
  887.  
  888. Subject:  Cookbook example of an outgoing NNTP feed:
  889.  
  890. This example involves a machine named oddball.mentorg.com, that has an
  891. alias of oddball.sjc.mentorg.com, which should receive all posts (but
  892. control & junk should never be passed on) and not certain
  893. distributions.  Add the following line to newsfeeds:
  894.  
  895. oddball.mentorg.com/oddball.sjc.mentorg.com:*,!control*,!junk/!local,!warren:Tf,Wnm:
  896.  
  897. Have the user "news" run the following via cron:
  898.  
  899. 3,23,43 * * * *  /usr/lib/news/bin/nntpsend >/dev/null 2>&1
  900.  
  901. (this only needs to be added once.  nntpsend refers to a file
  902. called nntpsend.ctl to find out what to do).
  903.  
  904. Add the following to nntpsend.ctl:
  905.  
  906. oddball.mentorg.com:oddball.mentorg.com::
  907.  
  908. Done!
  909.  
  910.  
  911. ------------------------------
  912.  
  913. Subject:  Cookbook example of an outgoing UUCP feed:
  914.  
  915. Example:  A site named "plts" that can not get the "clari" newsgroups
  916. or distribution "warren".
  917.  
  918. Add the following to the newsfeeds file:
  919.  
  920. plts:*,!clari.*,!junk*,!control*/!warren:Tf,Wnb:
  921.  
  922. Add the following to the cron tab (as user "news"):
  923.  
  924. 0 0-5,16-23 * * 1-5       /usr/lib/news/bin/sendbatch -c plts >/dev/null 2>&1
  925.  
  926. NOTE: I know that "plts" is unique and won't conflict with
  927. some other site named "plts" because it is registered
  928. in the UUCP Maps.
  929.  
  930.  
  931. ------------------------------
  932.  
  933. Subject:  Cookbook example of an outgoing UUCP-over-TCP feed:
  934.  
  935. jerry@strobe.ATC.Olivetti.Com (Jerry Aguirre) writes:
  936.  
  937. People ask about this like it was something exotic requiring special
  938. setup.  Kind of like: "I know how to use a wheel barrow and I know how
  939. to shovel sand but how do I shovel sand in a wheel barrow?"
  940.  
  941. Step 1:  Set up a UUCP/TCP connection between you and the destination
  942. site.  How?  Read your UUCP documentation.  If your, and the
  943. desitination's, UUCP supports UUCP/TCP then it will be documented.  If
  944. not then get a better version of UUCP.
  945.  
  946. The point is to get the UUCP/TCP link working before even thinking
  947. about sending news over it.  This is true of any news feed over UUCP;
  948. even dialup.  Try using "uucp" to copy some scratch file to the other
  949. end.  When you have that working then you are ready for the next step.
  950.  
  951. The only "gotcha" here that I can think of is that the destination host
  952. may not be accepting UUCP/TCP connections.  Before wasting your time
  953. trying to debug do a "telnet destination.host.name uucp" and see what
  954. happens.  If the connection is accepted and you see a "login" banner
  955. then it is ready for you.  If not then ask the admin of that site to
  956. enable UUCP/TCP.  This is typically done by uncommenting it in
  957. /etc/inetd.conf and -HUPing inetd (on REAL versions of Unix).
  958.  
  959. Step 2.  Set up a standard compressed news feed to the UUCP name of the
  960. destination site.  How?  Read your news documentation.  Setting up UUCP
  961. feeds is a standard, documented, procedure.  In this FAQ you'll find it
  962. in "Cookbook example of an outgoing UUCP feed".  Doing compression is
  963. nothing special, it's part of the procedure you would be doing anyway.
  964. It's either a flag or a slighly different command.  The news system has
  965. NO knowledge that this is UUCP/TCP.  For all it knows this is a
  966. standard dialup connection.  In fact is is possible to have the UUCP
  967. connection fall back to dialup if the TCP connection fails.  The news
  968. batching software just doesn't care.
  969.  
  970. The only variation here I can think of is to make the batch size bigger
  971. than the default.  The 50K default was picked back in the days when
  972. modems were 1200 BPS (or even 300).  It is no longer appropriate for
  973. todays 9600 BPS or faster connections.  Using a bigger batch size cuts
  974. down on dead time in the connection and lets compress do a better job.
  975. I would go to at least 200K batches.
  976.  
  977. Now maybe it would be nice to have a "cookbook", step by step, set of
  978. instructions on how to do this.  But UUCP seems to vary a bit between
  979. different versions so what might work at one place would be useless at
  980. another.  And setting up the news feed is going to be different between
  981. the different versions of news (B, C, and INN).
  982.  
  983. I suggest that if people are having trouble setting up a UUCP/TCP
  984. connection that they post their configuration to the net and ask how it
  985. is done on their versions of Unix and UUCP.
  986.  
  987.  
  988. ------------------------------
  989.  
  990. Subject:  Testing an outgoing feed (your "newsfeeds" configuration).
  991.  
  992. Here is a decent game-plan for testing your newsfeeds configuration:
  993.  
  994. Suppose your site is in New Jersey and you have a distribution called
  995. "mentorg" which should be used by people that want to make sure that
  996. their post will not leave their company (Mentor Graphics).  You should
  997. do a test post to "nj.test" with no "Distribution:" header, and with
  998. "Distribution: nj" and "Distribution: mentorg".  After posting, do a
  999. "ctlinnd flush ''" and make sure that the /var/spool/news/out.going
  1000. files for all your sites did/didn't queue up those three messages as
  1001. appropriate.
  1002.  
  1003. IMPORTANT:  Remember to do a "ctlinnd reload newsfeeds x" command every
  1004. time you update your "newsfeeds" file!
  1005.  
  1006. Finally, for checking out changes to newsfeeds, I've found "ctlinnd
  1007. checkfile" handy.   "inncheck" will verify that most of your
  1008. configuration is sane.
  1009.  
  1010.  
  1011. ------------------------------
  1012.  
  1013. Subject:  Other cron jobs.
  1014.  
  1015. Once a night you should run the "news.daily" script which will
  1016. expire old articles, run the daily reports, etc.  It should run
  1017. as "news" and look something like this:
  1018.  
  1019. 40 23 * * *               /usr/lib/news/bin/news.daily delayrm
  1020.  
  1021. If you get news feeds via UUCP, you might want to add this cron
  1022. job (also as "news") which checks to see if any batches arrived
  1023. while innd was down and processes them.
  1024.  
  1025. 20 * * * *                /bin/rnews -U
  1026.  
  1027.  
  1028. ------------------------------
  1029.  
  1030. Subject:  Cookbook example setting up NOV ("overchan").
  1031.  
  1032. Now that you have your other feeds working, you might want to set up a
  1033. NOV feed so that your NOV database is built.  Newsreaders use the NOV
  1034. database to speed up their queries.
  1035.  
  1036. Christophe.Wolfhugel@grasp.insa-lyon.fr (Christophe Wolfhugel) (with
  1037. many modifications from Tom Limoncelli) writes:
  1038.  
  1039. Step 1:  Upgrade to INN 1.4 or higher:  Most of the bugs in 1.3 were
  1040. related with overchan.  In fact, the reason why many people used 1.3
  1041. without any problems was due to the fact that they were not using
  1042. overchan (and didn't hit on some of the bugs that appeared for SVR4
  1043. users, all of which were fixed in 1.4)
  1044.  
  1045. Step 2:  Make sure INN is working.  Get everything else working before
  1046. you try to get overchan to work.  You'll only confuse yourself.
  1047.  
  1048. Step 3:  Ponder if you have enough disk space.  NOV uses up an
  1049. additional 10%-20% of your news spool.  This is a good 100 Mb if you
  1050. have a full feed.  The real space savings come when you delete your
  1051. separate databases for trn, nn, and tin and use one unified database.
  1052. All serious newsreaders will have NOV support soon.
  1053.  
  1054. Step 4:  Edit overview.fmt (it's in the $INN/site directory, or you can
  1055. edit it where it was installed, in /usr/lib/news ) to include
  1056. "Xref:full" as the last line.  (i.e. uncomment out the last line).
  1057.  
  1058. Step 5:  Add this entry to your "newsfeeds" file.  overchan gets it's data
  1059. from a special feed.
  1060.  
  1061. # This feeds header data to NOV:
  1062. OVERVIEW!:*:Tc,WO:/usr/local/news/bin/overchan
  1063.  
  1064. Read the "newsfeeds" man to make sure you understand what you've
  1065. just done.
  1066.  
  1067. Step 6:  (optional) To create the original database:
  1068.  
  1069.     (run this as "news")
  1070.     % /usr/local/news/bin/expireover -a
  1071.     % /usr/local/news/bin/expireover -s
  1072.  
  1073. If you skip this step, access will be slow for articles that came
  1074. in before you started "overchan".  This is not a problem.  You
  1075. will get a lot of warnings in your "news.daily" output until
  1076. you have received at least one new article in each newsgroup.
  1077.  
  1078. [ Note:  "a lot of warnings" means one for every newsgroup.  This can
  1079. make your news.daily report >6000 lines.  The lines will all look
  1080. like:
  1081. overchan cant open clari/local/washington/.overview, No such file or directory
  1082. overchan cant open clari/local/sfbay/.overview, No such file or directory
  1083. overchan cant open uc/news/.overview, No such file or directory
  1084. ]
  1085.  
  1086. Step 7:  Change the invocation of news.daily:
  1087.  
  1088. In the crontab file for "news", edit the "news.daily" line to be
  1089. something like:
  1090.  
  1091.    news.daily delayrm expireover
  1092.  
  1093. (the expireover is required if you use overchan)
  1094.  
  1095. Step 8:  Inform your users that you now support "NOV, the News OverView
  1096. database" and suggest that people switch to newsreaders that use
  1097. newsreaders that are compliant with the Overview format.
  1098.  
  1099. Step 9:  You are done.
  1100.  
  1101. Step 10:  In a few weeks, drop support for mthreads, nnmaster, etc.
  1102. (assuming you've upgraded to replacements that use NOV)
  1103.  
  1104.  
  1105. ------------------------------
  1106.  
  1107. Subject:  How do I use nntplink with INN?
  1108.  
  1109. First of all, I don't personally recommend using this program.  I feel
  1110. that it is a gimick.  However, if you decide to join the INN Instant
  1111. Propagation Party (INN-IPP), I suggest that you first run the feed using
  1112. traditional methods for a month so that you make sure you are used to
  1113. INN and make sure that the feed is properly functioning.  Once you're
  1114. ready, here's a cookbook example of an newsfeeds entry using nntplink.
  1115.  
  1116. PLEASE make sure traditional "nntpsend"-style feeds work reliably
  1117. before you switch to nntplink.
  1118.  
  1119. netcomsv.netcom.com\
  1120.     :*,!junk/!ParcPlace\
  1121.     :Tc,Wnm,S1024:/usr/local/news/bin/nntplink -i stdin netcomsv.netcom.com
  1122.  
  1123. INN 1.2 users should have an explicit S value (i.e. S1024 or S16384).
  1124. Without it innd 1.2 can choke and lose data if the receiver is jammed.
  1125. (fixed in INN 1.3).
  1126.  
  1127. The latest version of nntplink is available from
  1128. shape.mps.ohio-state.edu:/pub/nntplink/3.2pl1.tar.gz.
  1129.  
  1130. Ian Phillipps <ian@unipalm.co.uk> notes some criteria for using
  1131. nntplink rather than nnptsend:
  1132.  
  1133. > (1) If you have more than one backbone feed, you can save a lot of
  1134. > bandwidth, without risk, if you use nntplink (less duplication of
  1135. > articles over nearly-parallel paths).
  1136.  
  1137. > (2) More important, if you have a large number of feeds, nntplink
  1138. > permits them to be fed simultaneously with the same articles.  No big
  1139. > deal, until you think of the what's going on in the pagedaemon and the
  1140. > disk cache.
  1141.  
  1142. > A "ps uaxr" rarely catches nntplink in the act ("D"), despite my having
  1143. > 17 of them last time I counted. Our biggest outgoing newsfeed delivered
  1144. > 16398 articles yesterday, using a total of 380 seconds CPU on a Sun
  1145. > IPC, and no disk time :-)
  1146.  
  1147.  
  1148. ------------------------------
  1149.  
  1150. Subject:  How do I use newsgate with INN?
  1151.  
  1152. This assumes you configured "mail2news" to put a distinctive
  1153. host-gateway name, like "news-mail-gateway" in your Path: headers.
  1154.  
  1155. In /usr/lib/news/newsfeeds:
  1156. ====================================
  1157. ##
  1158. ##  NEWS/MAIL GATEWAY
  1159. ##
  1160.  
  1161. tech-gateway/news-mail-gateway\
  1162.         :ne.nearnet.tech\
  1163.         :Tp:/usr/lib/newsbin/news2mail \
  1164.         nearnet-tech nearnet-ops nearnet-tech-request nic.near.net %s
  1165. ====================================
  1166.  
  1167. On the mailing list side, one of the recipients is:
  1168.  
  1169. post-nearnet-tech: "|/usr/lib/newsbin/mail2news -n ne.nearnet.tech -o 'NEARnet News/Ma
  1170. il Gateway' -d ne"
  1171.  
  1172.  
  1173. =====================================================================
  1174.                OTHER ERROR MESSAGES AND WHAT THEY MEAN
  1175. =====================================================================
  1176.  
  1177.  
  1178. ------------------------------
  1179.  
  1180. Subject:  ld.so: Undefined symbol: _dbzwritethrough
  1181.  
  1182. > Everything compiles correctly, but when I try to test rc.local I get:
  1183. >
  1184. > hermes# sh /usr/local/etc/rc.news
  1185. > ld.so: Undefined symbol: _dbzwritethrough
  1186. >
  1187. > What am I doing wrong?
  1188.  
  1189. This means that you are using a $INN/lib/dbz.c file that hasn't been
  1190. patched with the $INN/lib/dbz.pch patch.  Apply that patch file to
  1191. dbz.c and rebuild libinn.a et al. and things should be copacetic.  See
  1192. section "5.2 The DBZ package" of the Install.ms document.  This might
  1193. have happened if you don't have the "patch" program (available from any
  1194. FSF/GNU archive).
  1195.  
  1196.  
  1197. ------------------------------
  1198.  
  1199. Subject:  Why does my innd often die with the message "Can't sync history,
  1200.         interrupted system call"
  1201.  
  1202. Are you running SunOS?  See "Known Problems" section of the
  1203. installation manual."  To the best of my knowledge, nobody has seen
  1204. this problem on any other system.
  1205.  
  1206.  
  1207. ------------------------------
  1208.  
  1209. Subject:  syslog message: ME cant sendto CCreader bytes 4 No such file or directory
  1210.  
  1211. (Rich Salz replies:) It usually means that some ctlinnd command timed
  1212. out and gave up before innd could get around to replying.  Always a
  1213. problem with datagrams.  :-)  Usually not a problem in real life
  1214. however.  In INN1.3, the timeout stuff is handled better so most of
  1215. these should go away.
  1216.  
  1217. You can ignore the messages, but if it bothers you, edit news.daily and
  1218. find this line:
  1219.  
  1220.     ctlinnd -s -t`wc -l <${ACTIVE}` renumber '' 2>&1
  1221. You can rewrite it to be something like this:
  1222.     COUNT=`wc -l <${ACTIVE}`
  1223.     ctlinnd -s -t`expr ${COUNT} \* 5` renumber '' 2>&1
  1224.  
  1225.  
  1226. ------------------------------
  1227.  
  1228. Subject:  inews says "bad message-id"
  1229.  
  1230. If this is a Solaris 2.x system, you didn't delete the lines mentioned
  1231. in "SVR4, Solaris 2.x, and SCO ODT 3.0" in part 1 of this FAQ.
  1232.  
  1233.  
  1234. ------------------------------
  1235.  
  1236. Subject:  Why do all these "readclose" messages show up in my syslog?
  1237.  
  1238. Chris Schmidt <cs@germany.eu.net> says:
  1239.  
  1240. The "readclose" message indicates that a remote connection to your
  1241. server was not correctly terminated with the server-command "quit".
  1242. This can have two reasons.  First the line your feed uses to connect to
  1243. you might be instable so that the connection drops every now and then.
  1244. Solution:  either ignore theses messages or find out why the line is
  1245. unstable.  The second reason for these messages could be a
  1246. missconfigured client-program at your feed.  This means the program
  1247. (e.g nntplink) does close the connection without sending the "quit"
  1248. first.  If you configure a lower number for the exit-timeout (-e) than
  1249. the close-timeout (-C) in nntplink then exactly this will happen.
  1250. Solution:  ask your feed to fix its nntplink-setup.  Let me repeat
  1251. that:  If you are using "nntplink" your -e value must be higher than
  1252. your -C value.
  1253.  
  1254.  
  1255. ------------------------------
  1256.  
  1257. Subject:  "File exists writing symlinking article file -- throttling"
  1258.  
  1259. QUESTION: I'm running INN 1.4, and the server throttles itself, saying
  1260. "File exists writing symlinking article file -- throttling".  Why?  I
  1261. have no clue, other than to note that the message is being emitted
  1262. while innd/art.c tries to link a crossposted group.
  1263.  
  1264. ANSWER:  Innd wrote the article to comp/foo/123 and then tried to
  1265. symlink it to alt/bar/128 and found that the symlink failed with errno
  1266. == EEXIST.  This generally only happens when your active file does not
  1267. match your file/directory use.  The two most common cases of that are:
  1268.  
  1269.         Trying to use MMAP on Ultrix
  1270.         Trying to use MMAP on Linux
  1271.         Some strange interaction with tind.
  1272.  
  1273. If you are using Ultrix or Linux, turn off MMAP.  You don't have a choice in
  1274. this.  The Ultrix mmap() function does something completely different
  1275. than the Sun/BSD mmap() function.  The Linux function gives you some
  1276. of the functionality that Sun/BSD mmap() function has, but not enough.
  1277. (The Linux people expect to have it fully up to spec eventually.)
  1278.  
  1279. At least one person has reported problems with ICL DRS6000 SVR4 Unix
  1280. when using MMAP.  Try turning off MMAP if you find problems.
  1281.  
  1282. It has been reported that tind writes to the active file and this
  1283. confuses innd (innd assumes it is the only process writing to the
  1284. active file).  If you are using tin, upgrade to the newest version of
  1285. tin which can read the overview (NOV) database instead of the "tin"
  1286. database.
  1287.  
  1288. To fix the active file (which may be corrupted), make sure nobody
  1289. else is writing to the active file, then do
  1290.         ctlinnd renumber ''
  1291. to get things synchronized again.
  1292.  
  1293. If your history file is corrupt, you should do:
  1294.         ctlinnd renumber ''
  1295.         makehistory -buv
  1296.         ctlinnd renumber ''
  1297. (Note: the "makehistory" will take hours to run.)
  1298.  
  1299.  
  1300. ------------------------------
  1301.  
  1302. Subject:  "cant fopen <newsgroup>/.thread No such file or directory"
  1303.  
  1304. Q: nnrpd logs "cant fopen <newsgroup>/.thread No such file or
  1305.    directory" hundreds of times a day although I installed trn-3 and
  1306.    maintain an overview database.  Why doesn't trn use overview files
  1307.    instead of mthreads data?
  1308.  
  1309. A: trn-3 tries to open .thread files (or use XTHREAD) first because
  1310.    $spooldir/db.init still exists.  Delete it.
  1311.  
  1312.  
  1313. ------------------------------
  1314.  
  1315. Subject:  news.daily reports: "Expire had problems removing articles"
  1316.  
  1317. This message tells you that you need to look in the file
  1318. ${MOST_LOGS}/expire.log to find out what really happened.
  1319.  
  1320. On the other hand...
  1321.  
  1322. Expire reports this if it goes through the entire expire process and
  1323. didn't find any articles to remove.  It is normal to get this error the
  1324. first few days you are running INN.  For example, if the smallest
  1325. integer that appears in your expire.conf is a "4", then you're sure to
  1326. see this error the first four days you get an news.daily report.
  1327.  
  1328. However, those first four days are when you are still learning the
  1329. system and it can be very shocking to see the error.  "Eeek!  Did I do
  1330. something wrong?"  Nope, news.daily is just telling you that you have a
  1331. virginal system.
  1332.  
  1333. Rich writes a more technical explanation:
  1334. > When using the "delayrm" keyword, news.daily calls expirerm to
  1335. > actually remove the articles that expire listed in its "-z" file.
  1336. > As distributed, expirerm calls fastrm with the "-e" flag.  This
  1337. > flag says "exit non-zero if nothing was removed."  In the normal
  1338. > case, it is an error if expire doesn't find anything to remove.
  1339.  
  1340. ...and a system being 4 days old isn't the normal case.  So you
  1341. get the error.  Ignore it.
  1342.  
  1343.  
  1344. ------------------------------
  1345.  
  1346. Subject:  syslog: ME cant nonblock 15 Operation not supported.
  1347.  
  1348. I get the following "syslog" message in /var/adm/messages:
  1349.  
  1350. Dec  2 20:40:04 venus innd: ME cant nonblock 15 Operation not supported
  1351.  
  1352. Answer: (from paulr@umbc4.umbc.edu (Paul Riddle))
  1353.  
  1354. It turns out that this is happening because /usr/spool/news on the
  1355. machine running innd is an NFS-mounted filesystem, and innd is trying
  1356. to do an FIONBIO on my feed file, which is under /usr/spool/news/out.going.
  1357.  
  1358. (tal@warren.mentorg.com adds:)
  1359. All news transports (INN, C news, B news) want the spool partition to
  1360. be local.  Newsreader can read from an NFS mounted partition without
  1361. any problems but innd should only see local partitions.  NFS has a
  1362. blatant disregard for many of the file semantics that are needed for a
  1363. good netnews implementation.  If you don't agree, please feel free to
  1364. prove the authors of B news, C news, and INN wrong.  Include source
  1365. code. :-)
  1366.  
  1367. Systems without unix-domain sockets sometimes see this error.  Just
  1368. ignore it.
  1369.  
  1370.  
  1371. ------------------------------
  1372.  
  1373. Subject:  innd: ME cant update_active control
  1374.  
  1375. What does "innd: ME cant update_active control" mean?
  1376.  
  1377. Look at your active file.  One of the fields is "99999" and has to be
  1378. incremented to "100000" but there is no space.  Shut down innd
  1379. ("ctlinnd shutdown x").  Edit your active file to add more leading
  1380. zero's to all the numbers.  Restart innd.
  1381.  
  1382.  
  1383. ------------------------------
  1384.  
  1385. Subject:  syslog message: innxmit[1234]: max connect failed Error 0
  1386.  
  1387. John Line <jml4@cus.cam.ac.uk> writes:
  1388.  
  1389. If you get syslog messages like "innxmit[1234]: max connect failed
  1390. Error 0" when using nntpsend, it probably means you messed up a line in
  1391. nntpsend.ctl (specifically, missed out one of the first two fields).
  1392. While nntpsend.ctl is an obvious place to look for an nntpsend problem,
  1393. there is nothing obvious to link the error message directly to the
  1394. problem, because the text "max" is actually something invented by
  1395. nntpsend when processing the file, and doesn't exist in nntpsend.ctl.
  1396. It means the next-to-last field was null, but was the second field when
  1397. it should have been the third!
  1398.  
  1399. NB Remember to try inncheck when you have problems like this. I only
  1400. just thought of it, after finding the problem the hard way, and it
  1401. immediately reported "nntpsend.ctl:18: malformed line."
  1402.  
  1403.  
  1404. ------------------------------
  1405.  
  1406. Subject:  Can't open "/usr/local/news/shlock955", Permission denied
  1407.  
  1408. This usually means you don't have /usr/local/news owned by "news".  The
  1409. first time you run "make install" it should set the proper ownership if
  1410. you run "make install" as "root".
  1411. -- 
  1412. Tom Limoncelli -- tal@warren.mentorg.com (work) -- tal@plts.org (play)
  1413. "Psst!  Hey, Anthony!  Y'know what I        | Disclaimer:  I do not
  1414. like about existing?"  "Uh... uh... what?"  | speak for Mentor Graphics.
  1415. "Possessing a physical extension."  -TSA    |
  1416.